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OS-9 MEETINGS: 

Meetings are held at 7:30 p.m., the second Thursday o-F each month in room 109 at 
Sehome High School 

BENEFITS TD MEMBERS: 

As a participating member of our new Bellingham 0S9 Users Group you enjoy many 
benefits: 

1 . Newsletter 

2. 0S9 Bulletins 

3. Public Domain Library 

4. Technical help 

5. Lectures and demonstrations 
6- Periodic group purchases* 

7. Membership List 

8. Access to GIMIX Level-Ill DS9 

HELP WANTED! 

Our group needs editorial volunteers. If you can contribute with information or 
helpful experiences of your own, please contact Rodger Alexander. The health of 
our newsletter depends on contributions made by many members of our group. 

1 . ^ TH rs"Ts"s ueT 

OTHER SOURCES 
COCO SALE ! ! 
'C COMPILER 
HOMEWORK 



Reviews of othe r CoCo Magazines and Newsletters 

CoCo's days are numbered at Radio Shack so take advantage 
Upgrading the C Compiler for Level II operation 
More scriptfiles to play with 



SUBSCRIPTION INFORMATION: 

Newsletters srB available free to those in attendance at the monthly meetings. 

If you would like to receive the newsletter in advance by mail a subscription 
rate of S3 for 6 monthly issues or $6 for 12 monthly issues is available. 



Contact: 



Rodger Alexander 
3404 Illinois Lane 
Bellingham, WA 9S226 
(206) 734-5806 
Delphi: "SALZARD 



PLEASE NOTE: MAY MEETING IS THURSDAY THE 17th INSTEAD OF THE 10th 



OTHER SOURCES: 

Wnen you Day a Color GomDuter -from 
Radio Shack, a fiyer is included with 
sub-scr ipt icn infromation -For "THE 
RAINBOW" Magazine. oubl ished by 
Falsoft- Inc. At one time there were 
three publications that were 
speci-Ficaliy written -for the Color 
Computer. Besides "THE RAINBOW" there 
was also "HOT COCO" and the "COLOR 
COMPUTER NEWS", My favorite was "HOT 
COCO", and I have every issue. But 
when the format, of the magazine started 
changing vcu could see the end coming. 
Now, only "THE RAINBOW" remains, 
althougn it has been shrinking from 
ovBr 250 pages to 130. 

^8_M1CR0_J0URNAL 

NOT TRUE! There arG actually several 
magazines available that pertain to the 
Color Computer and/or 0S9- THE 68 
MICRO JOURNAL has been with us from the 
very beginning covering all 6S09 - 
68000 computers with emphasis on QS9. 
FLEX and other Ooerating Systems. "THE 
6bMICR0 JOURNAL" has been oriented more 
towards the programer and com-mercial 
and business users rather than the 
adventure game player. "THE 6SMICR0 
JOURNAL" was just too much "over our 
hee-vds" (soeak for yourself bub!), so 
few "CoCc Nuts" were even aware of "THE 
6SMICR0 JOURNAL". The "JOURNAL" has 
now gone almost strictlv to covering 
OSK (6S000 version of 0S9), which is 
again aimed at the professional and 
commercial applications. Owners of the 
new KLE^B "MMl" ana FHL's TC9 might 
find the "JOURNAL" vei-'v useful- but 
information on our favorite version of 
0S9 will be pretty rar^. 

?Q?5_CLlPB0ARD_MAGAZiNE 

■'he "CLIFBCARD" put. out it's first 
issue in October 19S7 and in many ways 
has crown to resemble a smaller version 
of "THE RAINBOW", This is not a put 
dawn and the publisher has worked hard 
iit filling the gaps that "the other" 
magazine misses- The "COCO CLIPBOARD" 
IS Dubiished bi-monthly and includes 
reviews, programs. reader mail and 
tutorals. An Amateur Radio article is 



included in everv issue. One thin^ 
different is advertizer's couoons 
included in every issue. Like "the 
other mag-azine" the "CLIPBOARD" also 
has "CLIPDISK". all of the programs 
printed in the magazine on disk, tor 
S49.95 a year. The most recent issue 
of the "CLIPBOARD" was 49 pages in 
length. A year's subscription (6 
issues) is $18. Credit cards accepted. 
Address: 3742 U.S. 20, Box 3, Fredonia, 
NY 14063 (716) 679-0126. 

MOID 

Stands for Message Of The Day, "The 
International Newsletter of the OS-9 
Users Group". The header reads "0S9 
Macintosh! 0S9 Clone! 039 Amiga! 0S9 
Atari! 039 CoCo ! 039 GIMIX!"'. The 
order of the different 0S9 Systems is 
made very apparent with each succeeding 
computers printed in smaller and 
smaller fonts. CoCo appears to be next 
to last, but I found the CoCo featured 
on oar with the others. And then 
noticed that the President of the C 
Users GrouQ is Kevin Darling, the 
Editor is Bill Braay, Bruce Isted is 
Vice President and Dale Puckett is 
Di rector-at-Large. Most of the reviews 
were for software originally written 
for the CoCo, although most of it (non 
graphics) would run on all CS9 systems. 
This magazine is oDviously for the 0S9 
fans only. Software listings are not 
included but QS9 development articles 
and software reviews makeup the major 
contents of the 10-12 page bi-monthly 
newsletter. The 0S9 Users GrouD also 
maintains an extensive Library (20 
DoubleSided 40 track Disk) of 0S9 
programs and utilities. Subscription 
to the "MOTD" Newsletter comes with a 
$25 membership in the 0S9 Users Group, 
Address is 1715 East Fowler Ave., Suite 
R237. Tamoa, FL 33612, The 0S9 Users 
Group Library of 20 Disk is $100. 

COCO_NOIES_NEU)SLEIIER 

This is a brand new endeavor. T'-^ 
June /July issue will be it's 1 Yt 
anniversary issue. The magazine is 
devoted to 50'/. 0S9 and 50'/. RS-Dos. The 
newsletter is in a maaazine format. 



a* wHOugh several previoas issues were 

available only an disk and the 

subscription is available in both 

printed format and disk format. The 

. _ _ . ^^ ^^ ^^^ 

3d 

. „. rate 

$12/year a 



SUUiaUr 1 p U J. U I ) lis d V d i l d U i C xii uu l- 

printed format and disk format. Th 
anniversary disk will contain 27 to 3 
articles, (mare than the prints 
format). The subscription rate i 
$12/year and the address is CoCo Not 
Newsletter, P.O. Box 45434, Tacoma, 
98445 
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HEY! ! ! LETS GET THIS GUY TO TALK AT 
ONE OF THE MEETINGS 

RADIO SHACK COCO SALE 

No this is not a paid advert i zement ^ 
BUT 

300 baud Modem Pak $9.95 

Deluxe Color Mouse $29.95 

Ch-8 Analog Color Monitor $199,95 

(works with Amiga and Atari ST) 
Color Computer-3 $129.95 

CoCo Software 32'/. to 677. Off 

!' " CAN YOU DO UJITH A 300 BAUD MODEM? 

X ..acked my Modem pak this past weekend 
and converted it into a Midi pak (well, 
half a Midi pak — it'll xmit Midi but 
I'm still waiting on a couple parts to 
finish the receiving section). I veri- 
fied that it worked by PEEKing and 
POKEing the pak from RS Basic, It 
seems to work fine. 

I still have to: 

- Hack the /MIDI driver that comes 
with UMuse (disassemble 

enough to know what's going on, 
patch the driver, etc). 
Disassemble?? Did I say that??? 

- Hack the /SIO driver (similar to 
the /Tl driver ) . 

(But this was for the serial port, 
if memory serves.) 

Hack the /T2 driver (copy to 
/MIDI , XMode it, etc) , 

John Sheer 



r^ -a„0N_AN_AMiGA2 

t quote me, but I think the CM-8 
pinout is; 

Gnd Red Biu Snd Ver 



(Har=hor iz , Ver=vertical • Snd= sound 

Gnd Grn Hor Pia 

Pia==i nternal pia pin - ignore) 

The amiga monitor is: 

- Gnd Gnd Red Grn Blu 
n/c Sync n/c n/c 

To use with an Amiga monitor (which 
expects composite opposite sync) you 
have to use a 74LS02 NOR gate. Take the 
coco Horizontal sync and Vertical sync 
into pins 2,3.. the output at pin 1 of 
the chip will be the composite Sync 
required- 

I use an Amiga monitor on my CoCo, as 
the CM-8 is on the KMA and the Amiga 
is in the closet <grin>. 



Kevi n Dar 1 i ng 

MODIFY YOUR C COMPILER 

This document is intended to assist the 
new C Developer with some of the things 
not covered in the manuals. First of 
all, READ THIS WHOLE DOCUMENT BEFORE 
YOU DO ANYTHING!!! It could save you 
some time. 

The first part cavers installing the 
Development Pack, Later it tells how to 
accommodate what it gives you with the 
C Compi ler . 

Next it tells how to move Microware's 
039 C Compiler to a single disk. This 
can be a hard drive or a large (3-5 
720K) floppy. This is fallowed by a 
discussion of various alternatives to 
usi ng ccl - 

This file refers to devices /dO and 
/dd. /dO is assumed to be the device in 
which the original floppy distribution 
disks are going to be read from, /dd is 
assumed to be the target disk to 
install the C Compiler on. 

This procedure also requires the save 
command. It is on the Development Pack. 
If you don't have the Development Pack 



and merely need to patch the C modules, 
you will need to obtain a replacement 
save command. Kevin Darling has written 
one (posted on CompuServe and Delphi) 
which is a DECB program which creates 
the binary -For you. 

This procedure involves the creation o-F 
several directories which you may or 
may not have. 

INSTALLING THE DEVELOPMENT PAK 
The Development Pack comes with several 
•files which aid in development with the 
Microware C Compiler. First of all, if 
you are using a hard drive^ I recommend 
copying all o-F the additional commands. 
Put )KA COPYJK of Side A of the floppy in 
device / dC and enter: 



0S9 
0S9 
0S9 
0S9 

0S9: 
0S9: 

0S9: 
0S9: 
0S9: 
0S9: 
039: 
0S9: 
0S9: 



chd /dO/cmds 

dsave /dO /dd/cmds ! shell 

chd /dO/sys 

merge errmsg /dd/sys/errmsg 
>/ dd/sys/er rmsg . new 
del errmsg 

merge helpmsg / dd/sys/he 1 pmsg 
>/dd/sys/hel pmsg . new 
del helpmsg 

dsave /dO /dd/sys ! shell 
chd /dd/sys 
del errmsg 

rename errmsg. new errmsg 
del helpmsg 
rename helpmsg. new helpmsg 



Take out that floppy and put in A COPY 
of Side B and enter: 

0S9: chd /dO/defs 

0S9: dsave /dO /dd/defs ! shell 

0S9: chd /dO/lib 

0S9: dsave /dO /dd/lib ! shell 

The directory /dO/MODULES is not needed 
unless you keep your system and device 
module library on your hard disk. I do. 
Here's how I copied mine: 



QS9: chd /dO/modules 

0S9: dsave -m /dO /dd/module^ 



shell 



a directory /dd/MODULES/HELP ) 

The directory /dO/SOURCES is not needed 
unless you think you would benefit from 
them. 

INSTALLING THE C C OMPILE R 
First thing move the library, etc to 
the target disk- Place A COPY of the 
floppy labelled "C Library" in drive 
/dO. Enter the following commands: 



0S9: makdir /dd/LIB 

0S9: chd /dO/lib 

0S9: dsave /dO /hO/lib 



shell 



Next move the defs files, 
same floppy in and enter: 



Leave the 



aS9: makdir /dd/DEFS 

0S9: chd /dO/defs 

0S9: dsave /dO /hO/defs 



! shell 



(This assumes that you already have a 
directory /dd/MODULEB and it contains 



Now we need to move the executable- 
Take out the library floppy, and put 
A COPY of the floppy labelled '^ 
Compiler" into drive /dO. Enter: 

0S9: chd /dd/cmds 

aS9 : copy /dO/cmds/ccl ccl 

0S9: copy /dO/cmds/c . prep c.prep 

0S9: copy /dO/cmds/c . pass 1 c.passl 

0S9: copy /dO/cmds/c . pass2 c.pass2 

0S9: copy /dO/cmds/c. opt c.opt 

QS9: copy /dO/cmds/c. asm c.asm 

0S9: copy /dO/cmds/c . 1 i nk clink 

Now, we need to patch two images, ccl 
and c.prep- You can patch them any was 
you prefer, I prefer to use dEd. These 
instructions show how to do it with the 
modpatch utility supplied with 0S9 LII. 

If you are going to use cc2 or cc then 
you do not need to patch ccl. Just skip 
down to the section on patching c.prep. 
It has to be patched regardless of 
which front end program you decide to 
use. 

To patch ccl, create and apply the f o i - 
lowing patch file (illustrated with the 
build command, use whatever way you 
prefer to make an ascii text file). 



0^"?= chd /dd/crnds 

QS9: build ccl.pat 

? 1 ccl 

7 c EE5 64 44 

? c EE6 31 44 

? V 

? (press CTRL/BREAK) 

0S9: load ccl 

0S9: rename ccl old-ccl 

0S9: modpatch ccl.pat 

0S9: save ccl ccl 

0S9: unlink ccl 

0S9: delete old. ccl 

As noted earlier, you MUST patch 
c.prep, regardless o-F which front "end 
program you decide to use. Patch c.prep 
similarly with the -Following commands: 

0S9: chd /dd/cmds 
0S9: build c.prep. pat 
? 1 c.prep 
? c 135C 64 44 
135D 31 44 

? V 

? (press CTRL/BREAK) 

QS9: load c.prep 

0S9: rename c.prep old. c.prep 

DS9: modpatch c.prep. pat 

059: save c.prep c.prep 

0S9: unlink c.prep 

0S9: delete old-c-prep 

These patches change the reference to 
/dl to /DD in both binaries. You're now 
ready to do it!! Just change your data 
directory to the directory which 
contai ns your source file(5). Make sure 
the execution directory is the cmds 
directory on the target disk. 

0S9: chx /dd/cmds 
0S9: chd /dd/ccwork 

Assumes you have your C source files in 
a directory called /dd/ccwork, or in 
some subdirectory, in which case you 
^■^ ".Id set your data directory all the 
down to that subdirectory, eg, 

0S9: chd / dd/ccwor k/sol i ta i re 



To compile a C program whose filename 
is hello. c you would enter 

0S9: ccl hello. c 

Special 1 net ructio ns : 

One way to speed up the compiling 
process is to pre-load all needed 
modules into memory first (and 
presumably, once). This saves on load 
time when actually running it. Also, it 
would help to have del and echo already 
loaded into memory (especially if you 
are using a floppy system). 



0S9 
0S9 
0S9 
0S9 
0S9 
GS9 
0S9 
0S9 



chx /dd/cmds 
load ccl 
load c.prep 
load c.passl 
load c . pass2 
load c.opt 
load c.asm 
load c. 1 i nk 



This can only be done on a 512k system, 
so if you have 128k, don't even bother 
trying. I personally don't bother 
pre-loading the system modules, since 
it only takes a second or two to load 
the module at runtime from a ST-225 20 
meg drive being accessed by a Burke II 
Burke CoCo-XTC interface, 

"Front-End" Program Notes: 

CCl is merely a "front end" to the 
compiler. It does not actually do any 
compiling itself, it generates the 
necessary commands to run each of the 
5 steps which are required to perform 
the compile, writes them to a file 
called c.com in your current data 
directory, and forks a process to run 
that script. Each of the 5 steps reads 
in a file from the previous step and 
generates an output file to be read by 
the next step. Using ccl, all temporary 
files will reside in the current data 
di rec-tory . 

The manual mentions a cc2 needed for 
Level 2- Forget it, it doesn't exist. 
Appar-ently when Microware realized 
that ccl, c.passl, and c-pass2 would 



all work just fine in Level 2, they 
decided not to develop the promised 
cc2, c.pass or ccomp. 

However, two enterprising so-Ftware 
developers have provided us with 
"replacements" -For ccl, both intended 
to be faster than the original ccl - 

The first is called cc2, written by 
Delphi /Rai nbow' s own Rick Adams- (He 
also wrote the CoCo 3 version of 
Tandy's Shanghai game, nice job, Rick!) 
It uses the pipe manager to pipe the 
temporary files from one step to the 
next. I have used it and it works well. 
It doesn't need to be patched to make 
it work with a single disk system. It 
comes configured to look on drive /DD 
for all libraries and defs files. It 
comes with the source, so it is a 
simple matter of editing the cc2.c file 
and changing it to suit your needs. 

The other one is simply called cc and 
was written by Carl Kreider- It will 
use a ramdisk device, /rO, if it is 
present, to store all temporary files, 
which makes it the fastest of all, when 
used with a ramdisk- Note, that a large 
source module requires a very large 
ramdisk, which limits what else you can 
be doing on your system at the same 
time. In fact you will probably not be 
able to load all needed modules into 
memory prior to compiling. Something, 
as I mentioned earlier, I don't bather 
with anyway since the load is so fast 
from a hard drive. 



assembler, a new linker and two 
supplemental libraries, most notable, 
the Graphics Library documented in the 
MultiVue Manual- Indeed, to utilize 
either of these two libraries, you will 
have to use the new linker provided- 
This means that you need to tell your 
•'front end" to use the different 
assembler and linker. 

ccl 

This is the most difficult. You will 
need to download CPATCH.AR in the 
Languages Library on CompuServe. It 
patches the modules rma (the new 
assembler) and rlink (the new linker) 
to think that they are named c.asm and 
clink. You will need to delete the 
original c.asm and clink prior to 
installing that patch. 

cc2 

This is a little easier. Just edit the 
source file cc2,c and change t' ^ 
following lines: 

CHANGE: docmdC'C.ASM 7.s.a -o='/.s . r \n" , 
base name (file) , base name (file) ) ; 

TO READ: docmdC'rma '/.s.a -o=y.s.r\n", 
base name (fi le) , base name ( fi le) ) ; 

AND CHANGE: docmd("C.LINK 

/dd/lib/cstart.ry.s 7.s -o=7.s'/.s7.s\n" , 

TO READ: docmdC" rlink 

/dd/1 ib/cstart.r7,s 7.s -o=7.s7.s7.s\n" , 

Then recompile it with: 



oc uses the defdrive() system call to 
determine the system device. To feed an 
appropriate value, an assembler module 
IS supplied with cc which can be 
modified to suit your system- It can 
then be compiled and linked with c.asm 
and clink, instructions arB included 
in the file ccdevice.a. I have changed 
mine to point to device /hO since there 
is where my LIB and DEFS directories 

Development Pa ck Consi derations with C: 
With the Development Pack you get a new 



0S9: ccl CC2.C 

cc 

This program is also very easy to 
change, since the source is provided. 
In fact the instructions for making the 
change in cc is in the documentation 
arB of the source file itself. Just 
edit the file cc h and read f " 
comments . 

Another thing I have done is to merge 
the libraries sys.l and cgfx.l with 
clib.l. Oh, before I get to that, I 



iAiww.i.d also highly recommend downloading 
"The Kreider Lib". It is a replacement 
file -For clib-1 written by Carl 
Kreider. It -fixes problems in the 
original library plus adds a whole 
bunch o-F new calls- Now back to the 
supolemental libraries. To merge them 
enter : 



chd /dd/iib 

merge cgf x . 1 



0S9; 

0S9: merge cgfx.l sys-1 clib.l 

>n. cl i b. 1 
0S9: rename clib.l old. clib.l 
QS9: rename n. clib.l clib.l 

NOTE: THE ORDER OF INPUT FILES IN THE 
MERGE STATEMENT IS VERY IMPORTANT,.. 
DO NOT CHANGE IT OR YOU WILL GET AN 
UNUSABLE LIBRARY, 

Doing this merge will cause all links 
to take longer, but you don't need to 
specify any libraries with the -1 
option (as depicted on page 10-2 of the 
^ ~**.iVue manual) anymore. If you make 
L of the make utility supplied with 
the Development Pack, you may decide 
not to merge your libraries in order to 
be able to minimize your link times. 

I hope this little file helps you and 
speeds you on your way to cranking out 
some quality C code for the Color 
Computer 3. 

Zack C. Sessions 



HOMEWORK by Rodger Alexander 

Last month we used Microware's macro 
editor to create a "startup" file. 
This month's lesson is an extension of 
the startup file concept. 

Textf i les that arB used to actually 
execute commands or otherwise operate 
the computer automatically a rG ca 1 led 
' ' scr ip tf i les ' ' oj^ ' ' proc edure f i J^e s ' ' . 
The fallowing "scr i ptf i les" will create 
a nienuing environment for your 0S9 
^em- Use BUILD or EDIT to create 
your "scr iptf i les" or use a text proc- 
essor - 



MAINMENLJ 

display lb 24 

1 ist. menu, da t 

prompt Make Selection: 

var.O (get selection) 

'/-O (execute selection) 

(NOTE: "prompt" is a basic INPUT type 
of command utility file included with 
SHELL+. ''var'' is a SHELL+ function.) 



MENU. DAT 

echo 

echo 

echo 

echo 

echo 

echo 

echo 

echo 

echo 

echo 

echo 

echo 

echo 



SYSTEM MENU 

WP Word Processor 

DC Dyna Calc 

DB Data Base 

TEL. • . . .Telecomm 
UT Utilities 



(NOTE: With Microware's macro editor 
or a text processor, it is not neces- 
sary to enter "echo" at the beginning 
of each line. These listing assume you 
arB useing the BUILD utility) 



WP 

echo Place Text Editor Disk in drive 1 

echo Press ENTER to continue. 

display lb 24 

echo 

echo 

echo 

echo LOADING TEXT EDITOR 

chd /dl 

chx /dl/cmds 

scred (text editor file to execute) 

display lb 24 

chd /dO 

chx /dO/cmds 

mai nmenu 

DC 

echo Place Dyna Calc disk in drive 1 

echo Press ENTER to continue. 

display lb 24 

echo 

echo 



LOADING DYNA CALC 



echo 

chd /dl 

chx /dl/cmdB 

dvnacalc </i 

display lb 2 ■ 

chd /dO 

chx /dO/crnds 

ma i nme nu 



(NOTt.: Follow the two above examplee 
"T^o*"' D B , TEL, UT or any other program) 

SUMMARY : 

In writing the above -Files, I am as- 
suming that your computer is ooerating 
with two disk drives. If you have only 
one disk drive on your system, change 
"/di" to "/dO". 

Also, vou may want to get a copy of 
'"datamod", a supp 1 imentary SHELL+ pro- 
gram. It will convert the above text 
tiles into executable modules that you 
^ "^ place into your commands direc- 
/. (Don't forget to ATTRibute them 
with *'e" so they will "execute".) 

Better yet, after you "datamod" all of 
your scriptfiles to the CMOS directory 
and ATTRibute them for execution, MERGE 
them together- and then LOAD them into 
memoKv for instant access/execut i on. 



COMPUTER-PRINTER COMMUNICATIONS 

by Scott Honaker 

Printers contain a microprocessor, code 
and character ROli as well as working 
and buffer RAM. The printer is de- 
sianed to pass the 128 ASCII characters 
that ^rB sent to it, to the paper and 
through special ASCII character sequen- 



ces, a i lowi ng addi ticna I cnaracLsrs and 
commands to be executed. 

There are two basic types of com.puter 
to printer communications, PARALLEL and 
SERIAL, A parallel port transmits all 
8 data bits s imul taneous I v , whereas a 
A* typical dot matrix prin^cer passes all 
characters fronri 32-255 (decimal) and 
prints them, Many characters below 
ASCII 32 are control strings, the most 
imoortant are listed below. 



6 


ACK 


7 


Bell 


8 


Backspace 


10 


Line feed 


12 


Form feed 


13 


Carriaas return 


22 


NAK 


27 


Escaoe 



A serial connection only transmits one 
bit at a time and has to include svn- 
chronizing start and stOD bits, 
cause of this, a parallel port is 
caliy fTiuch faster than serial, 
though less reliable over long 
tance . 



Be- 

typ- 

al- 

dis- 



In a serial port connection, there is 
no line that tells the orinrer how fast 
the data will be arriving and in what 
form. Because of this, it is necessary 
to be sure both the computer ana the 
printer are using the same protacol. 
The fallowing diagram illustrates how 
the character 165 would be sent to the 
printer. Time runs along the horizon- 
tal axis and voltage vertically. As 
baud rate increases, dur duration of 
each of these pulses is smaller. 
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stop 

bit 



+3.75-12 volts 
volts 



